home *** CD-ROM | disk | FTP | other *** search
/ World of Amiga / World of Amiga.iso / archive / 3d / radiance_bin.lha / README
Text File  |  1993-06-18  |  4KB  |  100 lines
  1. Second Beta Release of Amiga Port of Greg Ward's Radiance 2.0, Amiga
  2. port by Per Bojsen.
  3.  
  4. This archive contains the binaries of the Radiance system compiled
  5. with SAS/C.  The binaries requires AmigaOS 2.04 or later.  To use the
  6. shell escape mechanism (!) in scene files, etc., you also need the
  7. APipe-Handler, which should be available in a separate archive or in
  8. the Fred Fish library if you don't have it.
  9.  
  10. The Radiance system uses the `RAYPATH' environment variable to
  11. establish a directory search path for library files.  If the `RAYPATH'
  12. variable is not set the default value `RAY:lib' is used.  Thus, if you
  13. assign `RAY:' to the directory containing the Radiance `lib'
  14. directory, it should be possible to run the raytracer.
  15.  
  16. If you want to set up a search path using the `RAYPATH' environment
  17. variable keep the following in mind: the format of the `RAYPATH'
  18. variable is a colon (`:') separated list of directories.  If you want
  19. to include a directory with a colon in its name, then escape the colon
  20. with a backslash character (`\').  A backslash can escape itself, too.
  21. Hence, the default value of `RAYPATH' is equivalent to setting
  22. `RAYPATH' to the value `RAY\:lib' (quotes not included).
  23.  
  24. This release contain some bugfixes.  In the previous release the
  25. default value for the `RAYPATH' variable was wrong (the backslash was
  26. missing).
  27.  
  28. New for this release is the AmigaOS version of `rview', the
  29. interactive version of the raytracer.  `rview' currently supports four
  30. different screen modes (lores, lores interlace, hires, and hires
  31. interlace).  `rview' opens it's own custom screen using the maximum
  32. number of bitplanes the hardware supports (AGA is supported when
  33. running under 3.0 or later).  `rview -devices' lists the virtual
  34. screen device drivers `rview' knows about.
  35.  
  36. All programs are linked with special code that makes it possible to
  37. use UNIX-style quoting, command line pipes, and wildcards even from
  38. the standard Amiga shell.  It is therefore possible to use UNIX-style
  39. quoting and command line pipes in Radiance scene descriptions (when
  40. using the shell `!' escape feature).  This code is configurable with
  41. the `_MAIN_CONFIG' environment variable.  Set `_MAIN_CONFIG' to a
  42. string of option letters selected from the below:
  43.  
  44.         b  Use backslash as escape character (instead of *) and
  45.            enable C style special control character syntax (i.e.,
  46.            \t for tab, \n for newline, etc., except for octal and
  47.            hexadecimal notation, which is not currently supported).
  48.  
  49.         q  Allow single quote for quotations along with the standard
  50.            double quote quotations.  Things within single quotes are
  51.            taken literally (i.e., no globbing, a single backslash is
  52.            read as a backslash and not an escape character), while
  53.            escapes (\ or *) are expanded in double quotes.
  54.  
  55.         g  Enable globbing (expansion of file name patterns) with
  56.            AmigaDOS pattern syntax if `U' is not active.
  57.  
  58.         U  If `g' is active use UNIX globbing syntax, otherwise
  59.            noop.
  60.  
  61.         p  Enable command line pipes specified with |.
  62.  
  63.         P  Enable && and || pipes.
  64.  
  65. If the `_MAIN_CONFIG' variable is not set the default behavior is
  66. mostly equivalent to the behavior of standard SAS/C programs exhibit
  67. except for some minor bug fixes.  I have my `_MAIN_CONFIG' variable
  68. set to `pPgqb' (I use the standard shell):
  69.  
  70.     1> setenv _MAIN_CONFIG pPgqb
  71.     1> echo ${_MAIN_CONFIG}
  72.     pPgqb
  73.  
  74. Some of these features are only relevant when your shell doesn't
  75. handle them for you.  I basically added this code to allow the use of
  76. command line pipes, globbing and more flexible quoting from the
  77. builtin shell.
  78.  
  79. Any quesions and bug reports should be reported to me using one of the
  80. following addresses:
  81.  
  82.         bojsen@id.dth.dk
  83.         bojsen@moria.home.id.dth.dk
  84.         bojsen@lenler.adsp.sub.org
  85.         cbmvax!cbmehq!lenler!bojsen
  86.  
  87.         Per Bojsen
  88.         Maglegaards Alle 51, st. th.
  89.         DK-2860 Soeborg
  90.         Denmark
  91.  
  92.         Tel: +45 39 66 31 86
  93.  
  94. By porting the Radiance system to the Amiga I hope to introduce the
  95. many graphics interested Amiga users to a new level of photo realism
  96. in synthetic images.
  97.  
  98. A special thanks goes to Greg Ward for producing this great raytracing
  99. system and for his easy to port programming style :-)
  100.